home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / elecmail / pstats11.zip / MAILBULL.DOC < prev    next >
Text File  |  1993-04-07  |  7KB  |  164 lines
  1.                    Postlink RIME Mail Statistics
  2.                          Bulletin Generator
  3.                     (c) 1993  Gregory R. Barton
  4.                 ═══════════════════════════════════
  5.  
  6. Purpose:
  7. ────────
  8.     This program was written so that users of my BBS could
  9.     quickly see what time the last RIME mail run occurred
  10.     and specifically, what kind of messages were exported
  11.     and imported in each conference.  This bulletin will
  12.     also total all exported and imported messages.
  13.  
  14. Packing List:
  15. ─────────────
  16.     The following files are included in this archive:
  17.         RIMEBULL.EXE   -  The executable file.
  18.         RIMEBULL.DOC   -  The file you're now reading.
  19.         MAILBULL.CFG   -  Sample configuration file.
  20.         SAMPLE.BAT     -  Batch file to view the
  21.                       enclosed sample bulletin in
  22.                                   color.
  23.         SHOWNEWS.EXE   -  Utility I wrote to view files
  24.                       created with PCBoard "@Xnn"
  25.                               codes in color at the DOS prompt.
  26.            BLT18          -  Sample bulletin created with
  27.                           RIMEBULL.
  28.         FILE_ID.DIZ    -  PCBoard description file.
  29.  
  30. Setup:
  31. ──────
  32.     First of all, you will need to go into your POSTLINK.CFG
  33.     configuration file and make sure that the following line
  34.     exists:
  35.     
  36.             LOG=x:\postlink\postlink.txt
  37.     
  38.      This line will write a PCBoard caller's log-type file to
  39.     disk.  In this case, called POSTLINK.TXT.  You may name
  40.     this file anything you'd like, provided it meets DOS
  41.     filename requirements.  Also notice above that the "X"
  42.     in the drive-letter position means the drive your POSTLINK
  43.     files reside.
  44.  
  45.         Special Note:  RIMEBULL reads only the first POSTLINK run
  46.         in this LOG file.  You will need to make a NEW LOG file
  47.         after every mail run for RIMEBULL to operate correctly.
  48.         On my system, I simply make a backup of my LOG file and
  49.         then delete it in my event.  The next Postlink mail run
  50.         will then create a new LOG file.
  51.  
  52.     Next, you'll need to use an ASCII editor to make up a
  53.     MAILBULL.CFG file.  The format of this file is simple:
  54.         
  55.         Your BBS Name Here                   ;30 chars. max
  56.         Name of LOG file Postlink creates
  57.                 POSTLINK Import/Export Mode ("A" or "M")
  58.         Name of bulletin you wish to create
  59.         Title of bulletin you wish to create ;20 chars. max
  60.  
  61.         The POSTLINK Import/Export Mode is defined in your POSTLINK.CFG
  62.         file.  If you have IMPORT and EXPORT set to AUTOMATIC, use "A",
  63.         if not, use "M" for MANUAL.
  64.  
  65.     For instance, here is how my MAILBULL.CFG file reads for my
  66.     own BBS (inluded in this archive):
  67.  
  68.         Alachua    County Computer Users Group
  69.         POSTLINK.TXT    
  70.                 A
  71.         BLT18
  72.         Bulletin #18
  73.  
  74.     Once you have created your MAILBULL.CFG file, save it and put
  75.     it in the same subdirectory as your RIMEBULL.EXE file.
  76.  
  77. Running the Program:
  78. ────────────────────
  79.     To run this program, perform your POSTLINK mail run as usual.
  80.     Once the mail run has finished, Postlink will have created
  81.     the LOG file you specified in the POSTLINK.CFG file.  Now,
  82.     simply type RIMEBULL at the DOS prompt and your bulletin (as
  83.     specified in your MAILBULL.CFG file) will be created.
  84.           
  85.         ***********************************************************
  86.     Note that if an error occurs during the mail run (such as a
  87.     mail packet is not found), RIMEBULL will NOT create the
  88.     bulletin file, but will instead delete it and return to DOS.
  89.         ***********************************************************
  90.  
  91.     Here is a sample (minus the PCBoard "@Xnn" codes) of the
  92.     output RIMEBULL creates:
  93.  
  94.             ┌──────────────┐             Alachua County Computer Users Group
  95.   ──────────┤ Bulletin #18 ├──────────────────────────────────────────────────
  96.             └──────────────┘                                        04-02-93
  97.  
  98.             The last RIME mail run was on 04-02-93 at 09:04 hours.
  99.  
  100.                The following message statistics were generated:
  101.  
  102.       Conference        Exp   Imp           Conference          Exp   Imp
  103.     ───────────────     ───   ───         ───────────────       ───   ───
  104.     For $ale Echo        0    394         Common                 0    104
  105.     Tech Echo            0    107         Desktop Pub            0     24
  106.     Communication        0     17         Programming            0     37
  107.     Database             0      4         Windows                0    263
  108.     Job Bank             0     21         Shareware              0     56
  109.     Star Trek            0    229         Sound Cards            0     41
  110.     dCOM                 0      0         Strange                0     24
  111.     RIME News            0      0         PCRelay                0      6
  112.     Bible Studies        2    127         Flight SIMS            0     17
  113.     DOS                  0     47         PCB Support            0     37
  114.     RIME Sysop           0      0         LOCALBBS               1      0
  115.  
  116.        Totals:  Messages Exported -    3     Messages Imported - 1555
  117.  
  118.   ────────────────────────────[ End Bulletin #18 ]────────────────────────────
  119.  
  120.     For a COLOR sample of the above output, type SAMPLE at the DOS
  121.     prompt to display this same file in color (included in this
  122.     archive).
  123.     
  124. Other Info:
  125. ───────────
  126.     Included in this archive is another utility I wrote called
  127.     SHOWNEWS.EXE.  This little utility will allow you to view
  128.     files created with PCBoard "@Xnn" codes in color from the
  129.     DOS prompt.
  130.  
  131.     This program is also based on my first shareware program I
  132.     wrote, called NEWSMAKER (current version is NWSMKR31.ZIP,
  133.     available on Salt-Air BBS and several shareware CDROMS).
  134.     It is a utility that will allow you to automatically color
  135.     NEWS files for PCBoard and add a nice, headered output.
  136.  
  137. Registration:
  138. ─────────────
  139.     You are allowed to use this program for FREE for the first
  140.     30 days.  However, if you wish to use it beyond that period,
  141.     you must register it with me for $10.00.  Your support will
  142.     allow me to keep writing utilities such as this and/or
  143.     expanding them.  Any comments or suggestions will be greatly
  144.     appreciated also.
  145.  
  146.     Please send a check or money order for $10.00, along with 
  147.     any comments or suggestions to:
  148.  
  149.         Greg Barton
  150.         3334 NW 4th Street
  151.         Gainesville, FL  32609
  152.     
  153.     Phone: (904) 372-4765
  154.     BBS:   (904) 335-7289
  155.  
  156.     Thank you for your support of this program.
  157.  
  158. History:
  159. ────────
  160.     04/03/93 - Version 1.0 released to local beta testing.
  161.     04/05/93 - Version 1.1 released - Fixed "bug" where Postlink
  162.     writes a different LOG file depending on import/export status.
  163.  
  164.     End of History.